OpenApple 




Vol.3, Ho. 5 

ISSl 08854017 
nei«standpTk%:$2^ 
jdKriDoqpjrdiarge per p^e $015 



Making AppleWorte relational 

^tneinyMsichBrtidecmhowtpaea^ read 

coii^panionaitfcleonlM]iirtoieittB9U(ft6ies.i1^ 
thatptoinis& 

One of our subscdbos who's In a hmiylo see thts companion eirticle 
pointed out that amfllaiy piograms able to read and write several data base 
files at a time could turn AppleWorks into a reiationaf data base syatem 
Wbile I'd heard the words "rebtionai data base" many times and understood 
ttds ^stem vfis a powerful vay to stare data, I didn't really know much about 
it f^irit^eat uas tu^eked, however, and I started nosing through a book 
cdtedlltaMoseAfMrnecbyCJ. Date (Addison-Wssiey). 

AoQop^tlStD DQt^tte '''iB^^ modd" is concerned with thOK aspects 
of adBbt»se:ib strudb^llstategri^, 

Ibe Afrucbual patt «f the fdational model specifies that all data 
must be kept in tables. The AppleWorks data base does, in fact store your 
data that way You can see it by looking at one of your data base files with the 
multiple-record display, which puts each of your records in Its own separate 
low and each of your categories in a column, (Usually, however, you can't 
actually see all of tte oilutims bec^Jse some aiB b^md the light 6(j^ 
Qie saeea Unlike Sie^ipldliKtespieads^^ 
you to scroll ^deways to see tte otfier categc^ips,1g» cpiJiHtq^^^ {he 
open-apple-Llayout) oonunand, however, to moi« anyspedRc ootuinii onto 
the screen so you can see it) 

In addition to the general table structure, the relaticnal model also 
specifies that each row must contain exactJy one value for each column. 
AppleWorks albws you to put any number of values in a ttwKOtumn cell For 
example, look at Smith's "administer af cell flom Hils sanqrie data beoe;, 
irfiich is called "patient-medlcadon-times": 



patlsnt 



nedlcitlDn 



adraini5tBr at 



To conform to the relational model, this AppleVfeilafile must be modified 
so that only one value appears in each "administer af' CdLOne way to do 
this would be to change the data to look like this: 



adntlnlsttr at 



Smith 

Smi th 



Hk integrity part of the relational model has to do with these keys. 
There are two kinds of k^, primary keys and foreign keys. "Every table 
should have a primary key— that is, a field, or field combinatifB^tiiatsenK 



Aoioant rantilXK tt would appear, were imoited to fin the need for 
parfanaiy tegs~'los unique identifiers. Paradoxically, most pec^le view 
account numbers as impersonal, yet their function is often ultra-personal— 

to uniquely identify a specific person in a data base. Names usually aren't 
used as a primary key because more than one person can have the same 
name. 

What is theprimaiy key in the table shown earlier? Even ifwe used a patient 
number instead of "Smith," that column couldn't be the primary key because 
iMtfa leooirds refer tp Qk aanieiiatieiit 

tittftpeiffilliesistl^ cettnBttyi^llilea^to imagmetbe table 

gpowingtosonKttitylDsettds 



patient 



ngdicatlDn 



adnlnisliM' st- 



Siiiith.073 
Smith. B73 
Smith. 073 
S«jth,e?3 



Naprasijn ae:i 

Msthocarbam. 0H:i 

Nethocarbenicii IG:! 

Naprosyn 20; I 

ttethacarbamol Z4:l 



rtow, no single column has unique values, tiowever. Date did say that a 
primary key could be a field combinati on." Ibe piinpiy tay ofdife tme, in 
fact is a combination of al[ of its columns. 

If s important to understand that the word 'k^' doesn't mean the same 
thing as "column." While;, as mentioned earlier, no ipwcoiuma cefl in a 
relational data base can iiold more Uian one value,B fe^cm benradeii) of 
several values. Tbein^pcwlantttdngabout the prlnrai^ 
In the table can Mit tte same key value. The value tn the primary key, 
whettier made up of one or several columns, must unicjuefy identify each row. 
(It follows ftran this, and Date makes a point of saying It that a rov/s value for 
ttR primaqrkiy can never be '"nidi" or biank.) 



Tiibles with sxetii^ one value in each cell are said to be "normafized" 
Acoonllng to Date, nomulised latdes aie "a ^>edal-<ase of tbe oxufaiKt 

known in mathematics asa re[ation..,.Thewholeiddk»al modd isfguDdBd 

on elementary maUiematicai relaticsi theory." 

While a data iase with just one tatile could follow all the rules of a relational 
data base, the power of relation theory doesn't come into play until you have 
more than one table. While AppleWorks does allow you to have more than 
one table on Its desktop at once, it doesn't have any abilify to manipulate or 
viewdata torn two or more tables simultaneous. This is the major ttiing that 
prevents AnpIeHbiks bom being a relational data base ^^tem. ^xdllaiy 
progtams wWi the (o vssi and wdfee J^fldlbilGS' MH base fll^ 
however, could unite several ^plefHbiks tables into a true nMonal data 
base —a data base amsistiiq of a number of tables related to each other by 
means of le^" 




FIRST I'LL SWITCH OUT THE MOmERBCWD, 
THEH WEUTOVOURIDEA." 



3.34 CUMSfMpj^ 
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A "foreign key" ties one table to another (able linking with the second 
table's primary key. roreign keys do nothave to be unique (several rows in the 
"foiBign table" may be related to the same n3w in the "primaiy fable.") 
HowevBi; every value in the forei^ tey of a table must either be equal to a 
value in the primary ksy d the cither table or be null Said another vsy, a 
f^a^ lfEy links eadi low in its own table wtlli exacQy one row iaMmSs^ 
tadttfe. A bidgci key value that doesn't extet In the primary key of tte; jjite 
table is illegal. A blank foreign k^^, which means that the iwdo«snJ Vl!]l:tQth 
ar^thlng in the sexond table, is allowable, however. 

In our sample "patient-medication-tlmes" table, for instance, the "patient" 
column could be defined as a foreign key capable of linking thattable with a 
"patient-census" table that has exactly one FowforeadipatiQitlliepatient- 
census table might look something like this: 

patient roan physician primary nurse ailergies 



SmithfiTJ zes Janes.M Doe.ei yes 

In addition, the "locm," "physidan;' and "primaiy nurse" columns' of 
patient-census could all be foreign hsfs linking this tabic with othter tables. 
Even the primaiy key of this table, "patient" could be a foreign key into 
another table that also had "padent" as a primary key (that table might hold 
non-medical information about the patient such as address, phone number, 
aid insurance compariy). 

Ihe iwntipuialiD^ fiait irf the lelatknd model "oppsists Qf a pif 
opetatoiskmnmedy^tfelyje the leiytomiai^im^yit o|^^ 
lelatt&inal atg«i^ 4^ sm} 01 tntb 'sS^ fs operands and 
produces a new table as Its lesulT these eperators do things such as 
combine two tables (called JOIM), exfract certain rows from a table (called 
SELECT 01 RESTRICT), and extract certain columns from a table (called 
PROJECT). 

AppleW>rks has some of these powers. It paiticubr, it has two tods, open- 
apple-R(ecord sded) and open-apple-F(ind), for SELCCTbig certain mvis 
tmm a table. In Gonjunction with the clipboard, you can even use lb@se tools 
to moee ihe edi:»:liedicMs to a new table. 

Open-appte-KaqiDut) allows you (forces you. In ftKll to eibp^ 
columns from a table. Open-apple-Uayout) is not atnmfl^dtlB^IiE^ievei: 
The PROJECT operator is also supposed to ignore any redundantiiiB^ Raf 
example, if we were to PROJECT our patient-medication-times table "(»er^ 
patted and medicaUon, the lesutt sbasOA indlide m^ fm torn, natfiK; 

patiatt iadlcaUon 

Appl^Mfertis can't do tt^ 

In addition, ^pleWbrks includes no way to join two tables, The JOIM 
operator takes two tables and makes a new,- wider table out of them. JOIi^ 
requires that you specify a column In each table. It concatenates all nnss in 
vMdi the spesafied columns have equal values, Tor example 

(i a ti c n d B f 

ssa/csssss»»s=3? JOINad Uith 

K al bl Bl * cU al fj. 

x a; bZ cZ :| .az fi 

Si t3 b3 c3 . ^. m b3 f3. 

« e tf; t 



X al & 4, :tSL El 

x ,^ « fit ' 

H a3 ■ Si» ea - iS aZ rz ; 

y a3 b3 c3 d3 a3 ra ' 

The result shown here is called a "natural" join. If the "A" column appeared 
in ttie lesultltia table biice, instead of once as hevE^ that would be an 

(fiodce that JOIW is just a mathematica! qierator that works whether you 
have legitimate primary and foreign keys or not Column A isn't a legi timatB 
primary Key in any of these tables because the values in that column aren't 
unique. Consequently, Column Aisn't a legidmate foreign key in ar^ of these 
tables, either.Aforeign key can'texistwithouta legitimate priraatykey to link 
to. The foreign key is supposed to link its tows to exactlu one row in. the 
pdmaiy k^s tabte.lf thevaloes in the "pdmai; he^ aiBif!tunlque>thtste'£ 
possible,) 



In essence, then, a Relational MbBase SjfStem is software that 
supports the storage of data in tables made up of columns of categories and 
tows (^iecQidis.'Each table must have a primaiy k^ that is made up of the 
valUesto oneoripcHE cplfliims, The iaiues in ttie priiTiaiy key must uniquely 
!d@(tti^ f^idi van in file liable. Ildiles his^ dso hak foirdgn beys that tie each 
iMfiilbtable with the tiadi^Qmim^ aDQtbert^ If JM^ti^tb^t 
s^ond Mile's primary key The softwaie must support the relational 
operators SELECT, PROJECT and JOI!^ for creating new tables. 
■ AppleWorks provides a small subset of a relational system — it stonss data 
in a table and it provides a SELECT Operator. 

In his booh. Date doesn't address the advantages relational s>5tems have 
over the older WerarchicaJand neturorSdata base systems, fie sinipi\ posits 
that the merits of the systems have been well aired and that "most database 
professionals now believe that relational tedinology is the way the future." 

tl^E^me ciMtientii tenflsefstbH^ ea^ to 

expmA or redesign, and that they , provide powerAil tools for qwck^ 
extracting spedBc infbrmationGrom a large data base. 

IrVhen designing a relational data base. Date says, you need to first decide 
v»'hat "enddes" you are bying to organize and give each its own separate 
table. In our previous example, for instance, "patient" is an entity that should 
get its own table (patient-census). Each table consists of its primary key, 
vtudi is a Geld or Geld combination that uniquely identifies the rows in the 
tajble, and other fields, eacti of which ''represents a fact about die key, the 
Miitile tey, iiid nothMgMlif 1^ 

When a field in a "wide" table needs to hold more tiian one feet about the 
key, the best strategy is to create a new table. (When a "nanow" taWe needs to 
hold more than one fact almut a field, the best strategy may be to make that 
field part of the key and duplicatie the row— as we did in our patient- 
medication-dmes table, for example.) In our pat3ent-census table, one of the 
fields is for "allergies," A padent can have more than one allerm^ if we follow 
the same "nanow" sbrab^ that we used ks patien^tnedicahpn-tiines, we 
get 

patient room physicia" primary nurse allergies 



Smith. 073 2^9 Janas,e<« OaeAL penicillin 
5iiilth.e^ 2S3 JonsB.N DocSl raspfenrr'laa , 

There are two problems with this strategy. The first is that it uses up lots of 
storage for redundant information (whyshouldroom, physidan, and primary 
nurse take up space for each allergy?). The second is that "allergies" must be 
included as part of the primary key to keepeacti row unique. But if "allergies" 
is part of the primaiy key for this table, then our patient-medication-fines 
table, in order to link to this one, would have to look like this: 

pati3"^ ili^ergies fiiedicatlon administer at ^ 



Saith pGniclllln Naproeyn 18:03 
SkitH laepfaepfleB NaprtSyn iSiW 

Adding aller^ tQ tWs table Just so we have a foreign key to link back to 
the padent table's primary key makes no sense, either. So, instead, we 
incorporate "allergies " into our data baste b^usttig tbe "Xrfdc" stiat^ of 
forming a new table. Then we have: 

patigiit rdoii pht^ibtan (if i.iary mra.e atlarglaH 

Sai^^tfl^e?? &9 Jones.W DW.tl ya« 
and 

patient allar^tas 



Saith.e73 parlcUUn 
Sfiiith>a^ raiptHl¥Ji^ 

Using two tables is veiy efBdort and poweriiilfiDm tte data base system's 
perspective. Ftoma user'iS perspective, however; tables sudi as these maybe 
the best v«y to olpij^lft data: 

lAti^t . aXlsrgtes sditinlstar sit isillntlon 



S«iiIUt;<73 pmicUUn 8S;# Napniayn 

t^i^ptuitries Na^aicatVaitil 

Ze:M ;,M9pro9yn: 

ZAstt nathvartrainal 



<ftme]987 



Ojpeihilfqile 3.3S 



addilnister at r^" patient imdlcatlon 



03:00 ZBS S«ith,873 Naprosyn 

Hethocarbanol 
219 Singh. 029 Tetracycline 

/I VelgtiCKhsB^ We is called a "view:' A view etbacls {x&sdected data 
Qlitef a nimiberoliiifenent physical 

toausec Different users usually have difFerentviewsofadatabase.Aprimaiy 
nurse requfaes views that are diiferent from those the accounting department 
needs. 

Theie is a sense in which a view is a "report formal' printed to screen. 
However, in an ideal system, users could add to or modify the data in the 
uiKleiiying tables by editing the values in one of their views. You can't do that 
wiOiiaintedreports. 

Data base views m pmmf«itXKis,'nief f^bm tables to be 
shnctured in a way that is ^ ftir data storage, wfBi no correeiftrf all tor 
users. On the other hand, they allow users to sec and manipulate data in a 
WBy that is best for them, with absolutely no concern about the achia! 
structure of the underlying tables. 

The relational system described by Date appears to be a non-existent ideal 
— he regularly points out features that are missing fiom the four relational 
software padiages he discusses in his book, nonetheless. It doesn't sound 
bnposslble to create a simple, elegant. ^pleWforks-lihe relational data base 
for the Apple JI, PioDOS oertah%neieds («fnd deserves) a sophisticated dala 
base program. 

The software packages descritied by Date mostly use a "corrimapfllW' 
interface (like Applesoft's), though one pttfvldes a form that you fill out to 
access data. Hone of them take the more AppleWtarks-lihe approach of 
showingyou the actual data in a table you can scroll through and allowingyou 
to manipulate things by pointingat\*atyou are interested in. 1 suspect that 
a data base piDgram tlial worted like that that had the speed and simplicity 
cSipfiiSllarlss, and that vm progfsmmed>le (so that specific systems for 
primary nuises orfor user-group seadarLes or for Apple's softpielicensmg 
department could be designed and sold like templates) wotildbe a hit 

Meanwhile, as He wait for one of Open-Apptds subscribers to write 
this software, the rest of us may get some mileage out of manipulating 
AppleWorks data base files with our own pipgrams, 

You may remember from our March discussion of how to read an 
AppleWoite data base file thatthe fundamental idea is to BLOAD a section of 
thefile intomemoiy andF^ at It To lar^ an Applewcffks data base file we 
dojusttte opposdte-^i^ffi'^iii^ tt^^^^ 
ttiatiange. 

The range of memory we PCSK orlPOKE Is caflled a memory buffer. It must 
be protected so that Applesoft doesn't accidentally step on it The following 
Applesoft program lines, which also appeared in my March article, set up the 
bi^and iiiWze the ptE^iaiiK 

IiM.BEM Progrsni Initialization 

laia LDMDIj 1S3M + PEEK(IBS) + PEEI((186J«Z5G : REM CreatB lG3ai1-liijt! buffer, 
lase DCr rw PK?(nDR) = PEEKtPDR) + P£i:i((flDB+l)»Z5E : REM Z-byte peek function. 

.WSe eas = FN PK2(iaSJ-lS3a^ : rem BBE points £□ the beginning oT our buTfer. 
1352 BEN ^ BBG t isaa* : REM BEH points to the End of our buffer. 

1854 PMTR = EGG : REM PNTR polnU to our paeition in the buffier. 

llKe.:B?TE=B: rm BYTE; ptilntt to DBC-pMltlm lfl dm Ble- 

In tli^ March aitide, the 16384 in line 1052 was divided by 2. This atated 
space for two buffers. At the time, I said Hie second one would be used when 
I showed you how to write Appleiflforks files. Well, that's what I'm doing now 
but we're still using just one buffer, so there's no need for the division either 
here or back in March. 

When 1 wrote the March program, 1 figured this month's demonstration 
would read a teoord fiom an ^pleWforks file in the first buffer, do some 
interesting manipulations to it and write it into the second fDe using the 
second buffer Itt%t this month's demonstr^on g/iis its input <Ma mm a 
t^fil^ notm J^^^lllbrks^ Itn^ft^^^ de@lifii 
Just one AppleWtrtiis ffie at a dme— the one betag Mteai lo— and require 
just one buffer 

(A program that tried to implement the relational SELECT or PROJECT 
commands vw)uld have to deal with two files (one input, one output); a 
program implemenling JOIM, three files (two input one output); while a 
pio^m implementing the view feature might have to deal Mth a dozen or 
more files. Its not that confusing to deal with more than one file ota ttae by 
settiiis up multiple twifers, trust me. tjustdoii'twanttofm 
gettiiq iiilK) it tt^ month.) 



File structure. You may remember from March that an AppleWorks data 
base file has thiee main parts. In the beginning is the headetii^ch tells how 
-H^iiy iea)rds are in the ffie, how many categories are in each recpi^ vA^ 
names of thecategpriesatf^andother intes^tli^stuE MeictcoBiesa secto 
lfiatlicidsre]>oitlcMnafe,tf^ftyh£r^^ 
data. 

Each data record begins with a two-byte ixataA lengtti. Ttett comes a 
controf byte for the record's first category When this is less than 128 it 
indicates how many bytes of ASCII data are in the category When this byte is 
greater than 128, it indicates the next category or group of categories is 
blank. A value of 129 indicates one blank categoiy; 130, two blank; and so on. 
If the first category holds ASCII data, the data is immediately followed by the 
cqottol liyte for tlK second category, and so on. A conttcj ti^ of 255 ($Fr) 
inkls the Old oflite record; ifaiiy categories tein^ when tlK$^^ 
they are all blank. For a more detailed description, sec March's article. 

The reason this month's program gets its data from a text file is that Open- 
^f^tte has a new 800-number answering service, new subscribers will call 
this number (we hope) to order subscriptions. The answering service 
operators enter the caller's name, addr^, and credit card number into a 
computer. Every so often these "records" are sent to us by moderrL We 
needed a program that would b'ansfer this data into the ^pl^ibiks data 
base file we use for pzocessdngqedit card iiii:epction^^^ 

The strategy I used for oDtiverlirig the toctfiki dataiiit^ 
was to read one record from the text file, poke that record to the AppleVforks 
file image in memory, read one, poke one, and so on, until the end of the text 
file vras reached. This works Ijeiier than reading the whole text file and then 
poking the whole AppleWorks file because it uses a consistent manageable 
amount of memoryi tlete atethe arreqfS 1 used to hsM thedata: 

103; DIM 11(30] : RCH this array is fur atsgarlaa sf tha Input file. 

1032 DIH 0%(3») t REM this arraij ie for the £a-.B3orlaa sf tha output rila. 

IdSa Qin ea(M) : rem tr^is airai) is for enRtniL byt^ in the nutput Flls. 

leai DIM TD(3«) : REM this afraij is for HuE/df ta Ida in th8 output fllB. 

l$(n) is where I put the data I read from the text file. 0$(n) is where I put the 
data I wanted to poke into the AppleWorks file. In each case, the (n) indicates 
a category. My pioyam filled l$(n) by reading one record from the text file; 
manipulated that data and transferred it to 0$(n); poked the data in 0$(n) 
into memory; then w^ttbacktoread a newsetofI$(n)valu^ 

"111610(0) array vras fiUedJifstonce— ltlndl<;ate9MAiidi output categories 
Bdtts ih tiie special ApplcWbrta time/date format In my own case, all of the 
values in this array were zero. If you want output category 5 to hold a date, 
however, put a 192 into TD(5). For a time category use 212, Well look at this, 
andattheCB<n) array, more latet 

Data manipulation. If there was no need to manipulate the data, it would 
have been easier to simply use ^pleWoiks itself to load the 800-number 
ASCIt te^ files into a new data base file. Fipni there we could use tlie 

order !ii wl:iich the SOdnumber people talte each category of informatkm is 
(fiferentlrom the order in which the categories appear in the credit card file. 
Consequently, this didn't work. In addition, 1 wanted to check each credit 
card number for the correct number of digits and make sure it had blanks in 
alt the right places. 

Since Openi4ppte's own 80Q-number program is of litOe general interest 
I don't intend to reprint the whole thing here. I'll skip the part that reads the 
text file (see the January 1985 Qpm'Appte, page 2 for more on how to do 
Oiat] and 111 skipnrflstoftfieparttiiattiansiiersdata&DmthelS^^^ 
Qie strings. Just to ^ you a taste for that part of the [ffogram, 
howevef, here ai¥; a fievlines you might like to took at 

35-14 Dl(a>="bari card nunher" ; Q*(17)=-ERR" : D1(2S)="" 

3St5 IF I.EFTi(TI,l]='^- THEN □I(17)=-VlSfl' : GOTO 3550 

3546 IF I EFT1(T*,1] = ~5- THEN DI(17)="nC" : GOTO 3550 

35« 0*(25)"ltll]«" is not a VISfi/KC number." : GDTD 3G0B 

SISI}::$^ cBfMnw 'Utth progran 
EE? csn,tlnua ulth proara 

3G19 Dl(19)=lt[4] 

Line 3602 simply hansfers input category 2 into output category 2. That 
category accidentally appears in the same position in both files. Ifs the 
caller's name. Line 5615 transfers input category 4 into ouQxit category 19. 
That categoiy, which holds the caller^ stv^.address. diat)^ p^ttions 
between files, as most categories do- 
in Ones 3544 t&aDugb 3547 1 did some ^ndier man^ulattons. Output 
-catisgoiy Is for ttte aid^c^ number; l*!^ forlbe ocdttc^df^ (VISAor 



MC), and 25 for an error mess^e that will actually appear on the AppleVforks 
data base soEen and eicplain any problems with this caller's record. 

This program segment begins in line 3544 by assuming the credit card 
number will be bad and setting outputcategories and 17 to reflect that Any 
previous error message in catggoiy 25 is erased, however. Llrie 3545 checks 
to see if the &st digit of theaecUt end numberis a 4. If itis, thecadis a VISA 

tte part of the program Ihat foimats Qie card nun^er. 

Iftfie first digit of the OBdit cardnumtierisn'ta 4,line 3546 iMcM tb sec if 
it is a 5, which would Indicate a Mastercard numbet If the first digt of the 
number is anything else, line 3547 assigns an error message to output 
variable 25 and skips the part of the program that would leplace the "bad 
card numi>^' message in output field with the oonectty formatted number. 

AdfliiS ttK tiM. Vat mMesgif [ used fbr writlHs ^wldngl ttm output 
categMtes trttomemoiyinvohred two passes atthe lecard. During the flrst 
p^^l (sdculated Uie total Ieng;th of the reccffd and the value foir each control 
byte. During the second pass I actually POKEd Hie control i^tes and ASCII 
data into memooi Heie'slhe first pass: 

smt KM Hrlta m racard to rils F .-; 
Seei ISI c^tagarij ilata aoqiBCtad.m Ufnjl 
em REM tltna/datB TU In TDIn) , . 

6918 RL=1 : HEM rainimun -ccQ'd .=rgth (fimtVfF bytej 

6815 NBs8 : RtM CDuntEr 'or bLa"< categariBS" 

6820 FOR N»e TD NC-1 : REM Tor each category: 

SaSS Ca(N)-LEN(Qi(N)l : REM caic-lata control hyte 

6838 IF CB(N) > 127 THEN EHR=1 : GIS.E 69M ; REM data tuo long errcr 

6835 IF CB(N) ^ 8 THEN NB^NB+1 : GOTO 6868 : REM catsgory is blank 

S840 REM category is not biark 

EW2 BFLflG=8 : REM clear hlark -flag 

E944 IF NB>e THEN Ca(N-l)=12B+NB : BFLRt;=l. : NB=e ■ 

G946 - IF TD;N]=ig2 THEN CB(N)=6 : REM date category 

6948 IF TD(N)=212 THEN CB(N)'^ : reHtlme category 

6858 RL<tB.'fBFLflG+l4'Ce(K; : REII add catagory length to record length 

6868 m.T 

The cridcal variables in this section of the program are RL (record length) 
and CB{n) (an arrayfor the control bytes). RL is assigned an initial value of 1 in 
line 6010, This represents the final $FF byte. 

Between Unes 6020 and 6060 there is a loop that examines each categpiy. 
line 6020 sets the control 1^ for the curmit output categoiy to the lengUi 
(^tte ASCQ (kta. line 6030 checks to see if ttiatla^^grBa£erttaaiil27;ifit 
is, a subroutine ^own later truncates it and Beads ai&esaage10flieai|ite. 
The AppleWorks data base file Amnat dkiesnt aHour room ttian 127 
characters per categoiy; 

If a categoiy is blank, the control byte will hold a zero in line 6035. In this 
case, ne, a variable for counting consecutive blanks, is incremented and we 
immediately slUp to the next category If the control byte isn't zero, on the 
dbet hand, the category Isn't blank and lin^ 6040 through 6050 will be 
executed. 

Line 6042 mates suns thetefiagWll use later is con^cQy Inidalized. line 
6044 looks to see iftherewone anyDlanK categories immediately befoie the 
current categoiy. If so, the conbol byte for the previous (CB(Ii-l)) categoiyis 
set to indicate how many blank categories there were. 

So, for example, if categories 3 through 6 are blank, their control bytes will 
all hold zeros until, irfiile processing the non-blanh category 7, we get to line 
6044, Wfe leave the conbol bytes for eateries 3 through 5 at zero, but we set 
the control t^ foi categoiy 6 to 132, uddch indicates four blank categories 

Wbm we go to pdilng all these contnd bytes into memoiy welijitugp Qie 
ones set to zero, so the simple 132 wOi lepiesentall four categoriesfi'tftelSi^ 
image. If the final categories of a record are blank, all oftheir control bytes vrill 
hold zeros. In this case, we don't need to include a txintrol byte in the file— 
the record ending $FF telegraphs that all the remaining categories are blank. 

In addition to setting the control byte for the previous categoiy to "blanks," 
line 6044 sets BflAQ to one and sets l^B, the number of consecutive blanks, 
to bacKto zero. KIAQ make^ its iin^ appeiiaianoehi line 6050, iritete we 
sum tlvs teRgtti3fi^#iiecMegoifes tettglih of &ie 

record Bl^anjMii^mi^tl»teLll ihe "blanks " conbol bytn get indud^ in 
the Summation. 

Lines 6046 and 6048 look at TD(h), the time/date anr^ to see if ttie 
category under examination holds an Appf eWorks-format time or date. (Tor 
more information on diis format, see the March article.) If so, it forces the 
control byte to 6 for a date, or to 4 fora dme. The length of a date includes an 



ID byte and live fSi(3l chaeacteis; a time an ID byte aad Quee ASGI 

characters. 

Rnally, line 6050 adds together the BFLAQ, a 1 (for the control byte), and 
the control byte value itself (which holds the length of the data). After kx^ing 
through all the categories, RL will hold AellCnpiof the ^wAmi CB(n) will 
hc4d the GQiitiDl b^s for each categmy 

The nieatt step ip to poke fee rwoid into ttie rnerttd^ 

6188 tlEU rscord Into mmmii buFFtsr. 

6118 POKE PNTR«1.(IL/25S WX .p0<a In r«card Isfigth 

S112 P0KE PHTB.RL - PEK(PMTRtlJ*2SE 

Bllil PNTRMWR+Z 

6128 FOR th* TD NC:-! 1 HER fjjr eatagary 
E125 IF CB(H) = 8 THEN 6168 : R04 If blar«<, than skip to ICXT 
6138 POKE PHra.C8(Nj : PMTIM>HTRfl : REM poka In contnil byta 
6135 IF CB(H) > 12B TlCH 6168 : REM If blsrka, than eklp to HEXT 
6148 IF TD(H) > 8 THEN POKE PHTR,TD(N1 : PNTR=PNTR+1 : Ca(N).ce(H)-l 
6145 FDR 1:^1 TQ Ca(H; : POKE PKm4l-l,flSC(HIDS([»(N),I,in 5 NEXT 
6158 PNTfl=PNTIWa(N) 
6168 NEXT 

6178 POKE PNTfi,235, : PNTR=PHTR+1 : IKH MrlW »FT' It ami. o' raepfd 
em Vlim*l : m m^r dF racnrds „ 
6198 SET W 

Lines 6110 and 6112 poke the record length into the buffer. Uncs 6120 
through 6160 form a loop that pokes in each category's data, In line 6125 we 
check for a contid byte of zero; if found, we do no pokes and instead skip 
abeadtotheneictGa^^p^Line 6130 pi^aigrothef con 
Ifebflffisr. 

line 6135 looks to see if the control byte just poked waa a "blanks" byte. If 
so, we skip the rest of the loop. If not, we next look to see if this is a date/time 
categoiy. If so, the date or time ID b>te is poked into the buffer. Then the 
contro! byte for that categoiyis reduced by one; this is necessary because the 
actual ASCII data for a date or time is one byte shorter than the real control 
byte vatue indicates (it Includes the length of the date/tijne ID byte as well as 
the lei^ ofthe ASGI data). 

Finally, line 6145 IsapoikeloqtpM databtto the memoiy 

buffer. line' 6130 a^iiibES the fctfe poliifer. Wm all of a retard's 
categories have rnade it to the buffer, line 6170 pokes fn the reconl^ndlng 
$fT, Line 6180 then increments the number-of-iecords counter. 

The taeadar. Bveiything we've said so far Just kind of assumes that we've 
aliea<^ pokeda database (lie header into themmoiybufec In6^ 
dtiHIie With pokes butby steafing a hea6!afmiim'0as^ U& 

.187^ FS^'TBf LATE' : REM data beS6 file ub'U i taal a hsadOr Fran 

1188 REn Load First section of flla and dig stuff mt Of the header. 
1110 GOSUB 5588 : REN load rile 

1129 HI. - FN PK?(PNTR)i2 : ir H.> tlCH 8388 : REH header length 

1122 NH - FN PKZ(PNTRt3Bl : REM It of records in File 

1124 NC = PEEK(PNTR+3£1 : !F NC > 38 THEN 5988 : HEtl tt of catogoriBE 

1125 NF = PEEK(PNTR+3B] : IF NF > B THEN 5908 : REM It of report Formats 

These lines, with the exception of 1070, come straight from l^arch's 
ADB,READERpiDgram. The subroutine used by line UIO loads the AppleVlfoiks 
file in F$ into the memoiy buffer. The rest of the lines dig some interestii^ 
values out of the header. 

The not ttiii^ we need tp do is CRS^ the data base file we'll Jbe stioriiig 
data in,ThBlJSW&coTnmands<nnrMt&MS1($ew^ 
beausewearesped^g a s{»cialfiletype {fiD^—Appti^lkalkWUi^M. 
TheselineswDldDthat- 

mz mm i9«i{4] i*Q!E«Tr^iB(-t wer 

1214' POKE Zie;S I EDTQ E,;lt^ UOti off D»CRR 

lite IF l*EKt'S2Z]=19 THEH PfilUT B«l*t4);"DELETE-;l(» ! fiESUHE 

121B PRINT -ERROR B-:PEEK(2ZZ);- IN LINE ~;PZE<.[Z1B) * PEEK(Z19]»Z56 : STOP 

in line 1215 there is a r^erence tg em XS-DUmOOC rATtlTiAME 
llii;^ If Qiboo^,,tt mirans att^ 

pi^ibl^ by dieleting it line 1216 simply handles any cither enor that oocurs 
Wile our OrffiRRiouanc fe acth«e between line 1210 and the POKE 216,0 in 
Dne 1214, which turns OHERR back off. 

The next thing we have to do is move the buffer pointer ftom the l)eginning 
ofthe file pas(: the header, past the report formats, and past the fiistfBC0Rl<^ 
the file, which holds "standard values." Here's how to do that 



1228 REH oove pointer to ds'.a, resaulng flls if necessary 
1230 PmR-PKIH+35.7+(NC»22) : HEN skip past hEadsr 
■Mi If ir=t Wi 12» HEH atclp put PBpwt fBmts 
IZS* F* frlTCl tr 

12Be {F WTH4G» > BEN THEN BQSUB sm i BtBlB 55W 



1230 REM skip Duer stsidinj valiilT 
1291 RL = FN PKIWIH) 
IZSZ IF PNTH+RL+2 > BEN THEN GDSUB ES«8 
1253 PNTR^TRtRL+2 



eosue saw 



129S HR=0 : RE!1 reset nmber ur racarife to ZBrti 

The only trick to all of this is mafdng sure that we don't ovemin our buffer. 
(VSlb the big ^l^l&i'i^ liuffier yi&'is using this month Its no trick, Ixit you 

Naraif we assume a minimum buffer size of about 125R. This means the 
@tthe header will Gt in the buiTer and solves some problems. In line 1230 we 
nion« the pointer pa^ tiffi ^d of the h^la to the begii^^ 
formats. 

Back in line 1126 we dug the number of neport formats out of the header 
and placed that value in nr. Lines 1250 through 1280 form a toe-in-water 
IctdpthatwoTKs like this, For each leportformat that has been defined we add 



Is beyond 9ie end Whs buBbr. Wt Is, tben hf^m adual^ advancing (he 
pdnter call the subioutine at 6500 to save thepcnrtbn of the file thab in 
fiie buflerto disk, l^ext we call the subnoutine at SSOOtobad the next portion 
of the original file into the bufier. A similar toe-in-water scheme is used in 
lines 1290 to 1293 to skip overthe "standard values" record, wbich Is the first 
record in the data section of Uie file. 



The nnitfnes.ttiat do Ihe actual buf^ ioadirg ami fflvingloo^ 

5S00 REM iDid BBction of file into buffer 
SS10 BVTE=B¥TEf(PNTR-BBG) : P«TH=BBE 

552B PRINT CHRI(4');''BL0flD*sFl;*, TflDB, L1E3M, R-jBBE:', B'jBVTE 
5S38fiETUHN 

S5M l^;8»«t wint«m» Of tjgrfir to tllik- 

£511 i^fm -m ' ■ 

,^39 fi^sSVlt+L i PHTR=BBB 
mi REIUM 

The 'load " subroutine appeared in our March artide (1 did change the L 
parameter to 16384 ftom 8192 because of the larger buffer we're using this 
month, iiowever), Both subroutines take liili advantage of the extra parameters 
3aslcst]fStemallows with BLOAD and BSffl^ commands. The T' parameter 
^km lis to Hi^tilate nion-btnaiy ffles.- itiie "B" paratiieter aillows m to 
begin loading or saving at a specific byte in the file. 

More information atout the 'load" subroutine can be found in our March 
article. The "save" subroutine works by first calculating the length of whats 
about to be saved in line 6510. This length is the distance in bytes between 
the beginning of the buffer and the cunisntpointer position. Line 6520 saves 
(he image tn the buffer into the file, be^nning at the byte specified by the 
BYTE vari^ie. The first time the buffer is saved, BYTE will equal zero. Line 
6530 advances EYIf for subsequent sawe s. It si mp^ adds theleii0h' of 
imagejust ssied onb^ pitsvloiis value In {SITE, lids iln« also'iBS«js the 
buier pointerto the b^nnir^ of the buffer. 

One final place we need a toe-iU'Water scheme is when we are ac±uaUy 
poking cate^ries into the memory buffer. How about these lines, which fit in 
between those that determine the length of a record and those that actually 
poke a record into memoi}'; 




Ask 

Uncle 
DOS 



Our corrections this month come fwm Ingle Farm, 
South Australia, whence (^ten-Apple subscnbeTlM 
Oray points out that bacfc In Decemtier 1386, m 
page zm, hstf m^ W»m M ^mhann. ffte 
-cenEct address €^&ie Bg!^Scs^0m biput hoof; is 
45Sm^9l mt 'mOfM w m Oray also 
remfffifed me to menUon another error several of 
you nt^cedinour recent April issue— in my intro- 
duction to ftat month's letters fpage 5.18), liie page / 
should haue encouraged }pu to turn to was 3.5, not 
3.7. How that our coTOcfions are ouerfapplng on 
themselues, ! really feel like an assembly Imtffn^e 
programmer. 

I ms^mtanda^ape^Ote response we got 
tob^monffi's ail for Apple's ol^cers to (atea stand 
OR the issue of /^ple's software not following 
j^fpte's own protooDts T'Slot 3 KWdisfc rules." page 
3.30). Battier than change a few bytes of code, Apple 
quickly decided to solve the proWem by moving all 
its application software into a separate company 
and spinning the new compar^y to the puMc; 
according to thej^ril29JI^$bvetJ6mal(^i^ 
4J, Since l^rg^ so^^l^ oni^a^ mxr 

uAll now be no need to modify Apple products such 
as Appie¥brks, J^ple Writer, or Instant Pascal to 



the MiayOpen-^ple as fhepftet^Jkctor Irii^ppie's 
dedsfoa the facts speafc^r ftertiselues. bislead, the 
newspaper quoted John '^Scully " (whoever he is— 
the president of Apple has an "e" before the "i/"in his 
name) as sai/ing that the focus of the neuj compare 
will be to "create and market innovative s(^uiare for 
Appk:'sMadntosh and/^ple 11 computers." 

ifior one even more aghast andagape than/ 
^mBtff'^:w^ compare pmtuim a>^$^ 
inniM^e far 9ie 4|^e a. The mmpai^ loffi be 
headedh}} WBam V CwtpbeB, who is nowJ^ple's 
top marteting eitecutjue. CampbeU's contritjutions 
to the Apple 11 have so far been nil to negative. Under 
his leadership Apple has reused to promote the 
Apple II (and occasion^ actively discouraged 
sales) in business and uni»ers% marfcets. Under his 



^/^^ p^m stem Co stem-anS I pf^H Oiat 
innooattee stuff that comes fiom His con^idny wtB 
run only on a Macintosh, 

Paradmcally, his company's biggest product off 
the starting line will be AppleWorks, although none 
of the computer trade papers have picfced up on that 
startling fact yet. According to the Wbtt Street 
JoiamL neither (he titeie cpinpaqy rm^pmdwHs, 
XiM USE trre eradlEni^ itwg mean 

that euen the product names "^pfeHfarJcs" and 
"4pp(e HWter" loitt soon disappear from sight 

IVhat ail Ihls means to (he typical Open-^ppte 
reader is that the Apple II softwarenarket is on the 
verge of a renaissance. By totally dominating this 
raarJcef .since the introduction of .^ppieMforJcs, v^ppie 
acci'dentaliy squeezed many one-time Apple II devel- 
Qpers intoIBIV orftacmtoshpiDducts (or Mo stpa^. 
/expect the test o^fhcuedepetopersuini come jiacfc 
an<^/ofn both $urvti7fng4PP'e // square companfes 
and new companies we haven't heard of yet In the 
iKxt great software gold-ru^ 

lVhenia>Hple.^pfe'supcDmtngmarit:etwtthdrawai 
iijilfh^ recent liUrodacHon of the i/gi / see more 



(¥!pc»c«% fat ^06 Ssi^lmK deoelopers Chan 
even during the boom yeias of 1980^ Get out 
there and deiKiop something fnnouattoiE. / sirteli 
buffers in the, wind for a change. 

This issue of (^enApple is the first to be sent 
to more than 10,000 paying suiwcri&ers. We appredsie 
your support and encouragement Things are gfAng 
so weU I've decided to come out from underground 
and start aduerttsing (n Appie // magaztnes. / euen 
f^MB^^&^mn>iBe w0tm 600 number to 
tateontei 

Our adis itM appear in the My issues of Call 
■A.P.P,LE, l^ble, inCider, andA+ and wUl continue 
monthly thereafter. Loofc for them— each ad indudes 
a different tip from a previous issue of Open-Apple. 
In addition, each ad wUl also include some of the 
more complimentary things you've writien in your 
letters to us. Wm aAtiaifs 0tBn of Mu^ 



.only snippets of it here I>ecausel'S nst ufhat you're 
paying to read I've atoays hafedto aU that 
good stuff, houieuer, so I'm rea^ pleased/1efina% 
got someplace to putilish it 

/ occasionaiiy bill Open-Apple as the "meeting 
place of the world-wide Apple II community." Even 
so. even I was lanaied when we actually did a count 
last nmnth and found paya^ subs^xibem fn 54 
i^^att ooiintries, M:to odehrsk. /imade apo&it 
o|selec(lnga number of UMrid-ujide lettersfor Uncle 
OOS tfits month. fOur suhscribens outside the U.S. 
are an intelligent and active bunch— they'refareset 
sending us questions we can't answer.) 

The only bad news I have is that I've run out of time 
and space for the expo^tlon on the //gs memory 
manager that / promised you last rnonl^ Just gftie 
meSOmoredajiis.... 



Power to the Apple II 



1 live in West Africa where the 220 volt 50 cyde 
power is less lhan dependable. The power here is full 
ofsii^.d^brm-ormaiidBlImannetofbadi.'Ib 



1M. 3,110.5 



6e9«:i!Of' tfiil raeow fi't m hufrflr'' 

6696 IF IWB*a.+|:> ffiJt Sm EHB»a S BOTH S9M 

That is pietty much ehssiything >ou need to write AppIeWoijbs dataiiase 
files. Not so liaxl, was It? 'Rieie ax aiso a coiqde of encr routines that 
placed at the end of this article. I n addition, you'll Snd It lidpfkil to see the 
Ktual guts of a filewritina piDgram: 

15M FBIW EH(SH1:T1PEN TEXT.FILE' 

151ft CDS.B 2SW : RED oat rmxl rrmri from text: FKg 

1515 IF TNDf lSa» : REN if at sHd ttT! iwtt/^tla, tmffsr t quit 

1526 PRIKT "Racora 'iNR+1 : REM assure ug^'WJUBthtng' li hippjwliig 

IS» wsm aeea ; rem manipulato data 

1548 eiSUS eme : goto ISle : nin unte rscerd, Qntlnug 

15Se PRIM CHRJ(4); -CLOSE TEXT.FILE" 

15G0 PDKE PNTB,2SS : POKE PNTR+1,255 : PNTR=PHTRtZ ! REIf tuo ni«-«\dlTig IFFs 

15?0 GDSJa 5SM ; saws buffer to disk 

15BD-PDKE BBl.MC : CEM fix number-of-rBcurdb byte .. ■ _ 

ISae PRINT CHfill')J;-BSfWE-;HJ;-.TflD8,Ll,B3£,fl";eBG 

Line 1500 opens the tort file that holds the data We want to get into an 
AppleWorks file. Line 1510 calls a subroutine not shown here for leading one 
set of categories— one record— ftom that file. If this subroutine encounters 
an EMD Of DATA error, it should set the EOD variable to 1 before RETURTiing. 

ffet fdlow what happens when EOD comes bach 0, meaning there are 
mm seconds to lead. line 15M prints the cunent lecord nuniber to the 
^^tt^toasimtietetii^M 



subroutine, not shown here in fall, that does all the data manipulations. 
Line 1340 calls the subroutine that pokes a record into the memory buffer, 
then returns to line 1510 for the next record, 

When we get to the end of the text file, EOD comes lack 1 and we go to line 
1550. rirst we dose our text file. Then we poke two additional SFFs at the end 
of the fUe, which is the final detail of the ^leHbite data base fSe bmaL In 
ItiK WO, WBsavet^iMat^buRe^ disk. 

Unes 1580 end 1590 again use the BSAVE command, but this tline itdfli B 
set to 36 and L set to X to update just one byte of our new ffle. This is the bylE 
in the header that holds the numb^ of tBOonlS to ti^e Me, 

find that brings us to EHD. 

5988 HEK The file doaan't lock rtght"ppDhably a pragrain, not t fllti,, tiug. 
S91B HDf4E : VTflB la 

SgZ8 P^ln" "I've encauriLETEd an error in the fi]a's structure'' 
S930 PRINT - in record ";R;" and category ";N;".' 
5940 PRINT ■ 

5950 PRINT 'ThB flla-burfer begins at ";BBE;' and'snda at ";BEN;'.* 
5360 PRINT ' Tha 'huffer pointer is Rt hytB ';PNTS;*.* 
5330 END 

iSW-'REM error hsndUr for m^lta inettuetlraiB 
i9gS ON ERR GOTO S9XII, 6Sk- 

B3ffl EMSSJ-'Category ■"•ttTStfNlt' %tt ■raeouri- '♦SIBJtRJ*" aas fcruficated.'- 
6912 a»(N)4.ErB(IBtN)a27) f CBtM)=12? 
fi9U mo 6998 * ; 

J9)»^E»®*''I e«»'t . write recoril ■'"*§TR»{Hi»'' bacium iC'«**tS«Stl3U+ 
' longer than the unsru buffer.' 

3910: ffiINT tMSGI : RETURN 



teep my system healthy, I run the power through a 
220 to 110 volt bansfoipqrandtbentinDi|||tiaU4 
model Wmipm^iismi^bili^ 
chaigei I have 3 cheap 12 volt car batteiy Tbe battay 
connects to a Hrlpp-Llte 550C f oweiverter and my 
avnput^ plugs into that 

Some people here have run the same system, but 
with a less-expensi\'e 500 watt THppUte that is not 
frequency contmUedThei^ple doesn't seem tocaie. 

£(<gtt if^ Sier hard M iw@des pofect^ off tlx 
square wave powermy PlQw^veiferpiDvides.So I also 
have a very serviceable dsk system that will not 
oash. We have had several lull powo' ^uiesand the 
screen didn't wen jump, I have as much time as I 
want to flnisti a document, save it and park the 
heads. I could probably mn an hour or so without 
power, but that would risk discharging the battery 

A 15 fflnp charger seems to be the minimum 
il^qesip^^ to teisp^ bafte^ 
^isti^ up^ PiEViously I had an 6 an^ 220 
mt I couldn't run the ^tem continuously. [ would 
charge overnight to get about five hours of up time. 
Unfortunately, with that system it was very easy to 
discharge the battery by getting carried away on a 
long ni^t You only get a few full discharges of an 
auto battery. So now I'm on my second battery, but 
I've had no piobiems with the bigger charger. 

lltijeeunenitisivinii^'tlose^ than 220 the 
iriveiter gets a UQii |o0^ muif faim the 
charger and produoes dcse. to ihe 152 vi^ t^s^ 
limit for the Apple. This makes the screettudipe a 
little. 10 get the right output voltage, I can tan the 
charger to trickle mode for awhile or acQu$t toe 
transformer to a dilFerent tap. 

1 should mention tliat my lie has a Disk li card, 
■Hiunderdock, CP/H Plus, CCS serial card, Sider card, 
end Apple d6coIuinn card, i also have an Apple 
Noilitor ]Q «it!4 S^stan Saver fan plugged into the 
PowrtVerter.Wl^lWedtorun my riEC Splnwriter off 
the inverter 1 got a wiggly screen. The MEC Just thrives 
off the 50 cycle power from the transformer, however, i 
put a Transector surge protector between the trans- 
former and ttie jxinter to clean the power up a little. 

Bruce Slater 
WiameyJliger 



/cafled Jerry 5tepherd at Si^pterdi*Iar/ceting (PO 

toasfchow^ypjb^SQiirsoluttenittas and to 
pnd out uMt yequenqj oorttRjOecTmeans. Shepherd 
spectaUzes in seUing unirrtmnptaMe pouner supples, 
inuerters, and simiiar items, lie's a fountain of 
fn/brmation aiout this stuff. (See "fieuieuwr's Comer" 
in our Januarj; 1386 issue, page 98, ^-ntoit on 
uninterr^ptabte pou!erjSuppUes.j 
Shegtieni said yaursi^m h acdmi^scMkm 

ym ty mgetm Bfl&hiie Mtety, t^^ iUm m 
automotiue battertj, hoioeoer, ffe said that marine 
batteries are designed to provide a steady stream of 
power forlong periods of time. Automotive batteries, 
on the other hand, are designed to provide short 
bursts of power for slarfing engines on cold days. 
TTie voUage o/an automotfue batterjji staffs to drop 

t£i6(f,Jft&iil^pj^a marine istte/}/, on ihet^er 
tend, itjesirt iftBp uhttt about 80 per cent of tfie 
stored energy is gone. 

Shepherd also said that it's usual^ dteaper and 
easier to buy a battery charger locatly than to use a 
110 twit U.S. model And he thinks it's best to stick 
iiMh "frequency controlled" inverters, such as the 
one you have. This means it provides 60 cyde 
poieer. Shq)heTd said OieAppie tt Vm^yM vooikjiei 
^ witfiout frequency oonttot Mmme montos 
and other peripherals loonl. 

Finally, Shepherd said that any computer or 
peripheral that has a modem "switching-type" 
power supply works fme (eivn a bit cooler) wiih the 
sguare wave power your iiwerter provides. Only 
older equipment that uses a "linear" power supply 
needs sme mveAC. The THppL/te 550CftHaen«»fer 

Internationai AppleWorks I 

About half a year ago 1 installed a Checkmate's 
MultiRAM CX/512 in my German lie Its a pl^ but I'm 
only able to use it as a RAMdisk rather than to expand 
AppleWorks. I sent the warrant card to Checkmate 
together wito a question about how to expand the 



GermanAppldlljbil!SV6i5toril2.tM:IhaK^^ 

t g^ess flK same pioblimt koe^a^ wIto the 
simple program from Alan BiitLwtqi^ you puU^hed 
in november (page 175, whicli fs mIsnumberEd as 
2.78), that keeps AppleWorks from stopping on the 
way to the desktop. Bird's pioyam doesn't rEcognize 
my German version of Appldlbiks either: Is thena 
anyone able to help me? HansJusgatt Budjne 

&i3007 Qarbsen 9 ^stOeniHny 

of Api^emrie ana, ilea, am "gufis" laif fm flte 

U.S. versions our patch programs asiSume. Dennis 
talked to Ron LaMee at Oiedcmate about your 
problems. i^Mee said he has seen five international 
versions of AppleWorlts: German, fTench, Italian, 
Spanish, and ffebreux 

Checkmate juts^ittempted to jprodupe ei9>anders 
for some uiMt me 

appartt^ nci W^il^ n^^^red ^ exad cone- 
^ondence u)^9ie&'£r.S. ooioitei>piari^. Spedfically, 
the French and German uersions are supported, 
although LaMee says he's not sure Checfcmafe has 
received a disfc containing the most recent German 
uersion to verify the expander patches on. Since 
yourpreiious letter seems to have slipped through 
tfie <mi& he uM try, to get a copy of the German 
DefsEbii 12 exqpani^ to|^- if you donthmpm 
him soon the European distributor fm(^g0tm^ is 
Pandasofl, Apple VeitiB^ihandSer,B-lMiB&Vki2. 
You should be able to get 0ie upgrade sdfyxim 
through them aiso. 

As far as Man Bird 's patches go, muittple versions 
create multipie problems. A pfrtcfc, iiice the ones u<e 
pubiish here in Open-Apfie, is usu^y a smaJ! one- 
ortwo-l;;^ charge to aprogram's machine (ariguage 

psi^mo^fiesiBtB^7navearoundin^eapro0m 
behneen one oerston andanother. O/ten the (den&sf 
one- or two-byte change will work, but only if 
someone can figure out where the instructions to be 
changed haw; been moved. Consider that Appieifforks 
has been released in five of^iM U.S tensions, to say 
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nothing ofintemationai versions, andyouR immedi- 
ately see why m'dget nothing else done fmtook 
eoenf patch request we get seriously. 

mne^eless, Dennis and l think me need to do 
BMi^th^ tomafce the pateh instructions 11% puM^ 
msfe uME^isaL we're considering doing is to 
0e you a few bytes a/ the or^nal code on both 
siO^ofanypatchwepttnt. ^should beaZiieto use 
a '<Sskz3p''pmgiBmsuchasProSersBlOCKWVU)m, 
Quality Software's Bag 0/ THcka 2, Bessie Bros' 
ProBifter, Central Point's Copy U Plus or even the 
lie or Ugs Monitor to search for the code segment 
mtttihafige it no matter uihere iTs been moved to. 

Hmj^aMiCim wUhOiis tedmlquehOmtyou. gentle 

0^10^. ltsj!me<Sfflai&ihn^ii^ltismApplesoft 
program, such as S&d's orfginal, but not greatiy so. 
But we can't help you a great deal— the ^mc^c 
procedure would depend on exadly which program 
you used to make the tiamges. Qu^sttons? Com- 
ments? Jokes? 

A further compiicaflon Is that some code doesn't 
stay exactly Qvt same iphen Ws moo^ adittesses 
embeddettnM^^nimWi chai^^s^m^MOK 
case o/'fireRr pistes, even the r^ma^macStke 
language insliticffons change betweert Apjlte- 
Mbrfcs oersions L5 and 2.0, which fciUs a/lour hope of 
ffmng you a unioeisal way to find the spot that 
nee^sto t» diartged. 

ProDOS diiKtoiy confusion 

I am encounteiing a lot of problems when I by to 
stue Ihree or four programs (^pWorks^poini 
etclfon fhe same SJSixKii <|l^ Cahymih^? 

Bruce Fairy 
Rawda, Kuwait 

Tf^^tegyweusewhenmavingsetsof files to a 
large disfc is to create a subdirectory for each set of 
files (AFn^mORHS for ^pieltorJcs, APimiTER for 
Apple Wrter and so on). Then we copy all of the 
jUes on the ordinal pmgram disk into the appropriate 
5UbdirEctc»||. 

Tb sM.m ^p^f^^ # !S «s^U ^^(Xssuy to 

in, then''daah''the^)alm0s,^exan9ie,^a^ 
disk named /l/Tff: 

to run Apple ilrltar: 
PREFIX /•JNI/HPLWEITEH 
-BH.SVSTEfl 

tc run nppleUoris: 

PREFIX /UNl/flPPLEWORKS: 
-fiPLWDRKS.SYSTEII 

fOil^ jjiogram bdngstiirtsd Ssm1timQ0tT&^ $ 

Ottfoitm^!^ mt sS^iplms do this. Some looic 
in the mafn oofume dlnectory for their files; some 
force you to enter pathnames to their uan'ons addi- 
lionai fi/es. The latter are really apain if you mooe the 
files to another disk; once moued, the program 
configuration must tie re entered to fix the 
pathnames. 

^^pmgrms dxmt Kmni^ wbklisiip^^ec- 
fcnr^iN^ iimestiuteafivm^^dlmigej^pr^ 
after sCart;^. An sample is Apple tstiia; .uMch 
atu8{/s lof^forthe file it needs to initialize a disk In 
the cuirentiy active subdirectory rather than in its 
own jubdtnectorj/. TTiat shoiM be classified as a 



International AppleWorks II 

I use the AppleWDiksspieadsheetto display columns 
of fiigures, I would like a "blank vAen zero" option so 
that fields that contain a zero value display as spaces 
instead of "0.00," which I think looks untidy in a 
KpoTt If you aie scannuig a report witti a lot of zero- 
Medfidditls ^is^to itdss a sii^e Eetdset It!, sagr, 
■'0.80." My answer so fss is to piiiit the report ia fte 
clipboard, copy It into ^ word iHooessoij then edit 
out all the offending values, but is there a better idea? 

Although AppleVforks was designed Ibr flic U.S. 
market, it is also marketed international^ In spite of 
this there is no way to enteir a date in anything other 
than the lunny U.S. month-first fiMraat—nobcKfy else 
in the world does it this wa)i Does a^j^xxly 1^ a 
patii lb mateibe appear fit I ^tu»e geiM| ' 
accepted fimnat such as dihnmnvjy? 

Another "U.S. ony gripe is that the spreadsheet 
formatting options allow for a currency layout but the 
onfy currency symbol supported is the dollar sign. 
Does anyone know of a patch to change this to 
another character? Currently, ( either have a spedal 
column justtis kjldthe cunrency symbol, or I printto 
the word pmc«i^ imd repliape all the dollar 

f!as 3nyone&i]i]da«^toGneetfiE>^ 
to do proper ligtit jiMlcaUtBi? By ttds I mean a 
straight ri^it edge wtii a ragged leftedge. This layout 
is useful for adding page headers to the top right or 
bottom right of a page respectively and can also be 
used in a letter to put the date against the right hand 
margin (where It always used to be befoie people 
started using word processors), 

Ona diffei^t JbiutielalBd sM^jec^ 
that the d)ain»^tnd)setia|[tt]a^ eiECtiNhen 
you set a header or fboter in AppleVKirlra lemains in 
eiect^ien the header of fimtoris printed, even if you 
have since changed it For instance, if you define a 
header while in 8 cpi, then print your page in 12 cpi, 
the header is printed on the second and subsequent 
p^es at 8 qii wtthout havli^ to reset the pitch. 1 know 
it sftouIdwDiiii lltefi&tiiititiaBSt&t^Stitpdse UtS&i 
it • - 

KtnyfSond 
Herts,U.Ft 

A simple way to get biante instead of zeros in 
catcuiated cells is to set up an slFst^ement thai 
displays "J%4 " If a cell's ualue is zoo. ThmMt f^ 
your^rite diskzs^) program, ^dlfieMAS^ite 
Af^Vkirks progfam files, ma dottle 'MO-i^iiftis. 
Of course, ^ means i^ou canit useiW itsdfar^fnKtre, 
and it won't work with your data ceUs, but it should 
help. To find HA, use a disk zap program to search 
though tkeAppieVlk>rks SE0.M1 file forthe heKvalues 
02, 4E, 41 This sequence occurs on!j^ once in the 
uerstons uie'ue kxMiaL Change the ilBainf 41 fo 
20s(td2aas). 

One tif owr relaiSkss Australian rtad<ers, Dat^ 
GrJgg, compJained in Octo()er 1986 about the ApfAe- 
Hbrfcs date format COf mice and macros." page 
2.68), then went out and devised himseif a patch to 
fix it. The patch is too long to print here, but well 
send a photocopy along to any subscritier who asfcs 
for one before we lose It. Australian readers can send 
a stamped seif-addressed enueiope directij^ to (h^. 
at JSSemnfii&d. meaait. Vkioiia. ^035. 

easu until we disaxered that the ASCS code for 
also happens to be the o^-used 6502 BIT instruction. 
Houjeoer, by process of eliminatiort, Dennis figured 
out that if you look through SBQJ11 for the hex 
mpiBtOi Aa, 24, ywiTl find the b^ ^pu^re 



locking for. Change the $24 to a $23 to start seeing 
pounds steritng. 

We've always had just^cation on our wish 
list, too. 
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t ha!»jM?t ^»led using VIP Professional and 1 am 
h^UESsid— tacsept that I end up seeing piirple after 
U. fcng session with the program and my green 
monitor. I think WuitiScritie is very considerate in 
proriding an invert screen funcUoa 1 s there something 
else I can do to invert the screen short of bi^ii^ a 
color or ambermtaiftor? JohnMamtitil 

iife$tmead,nSW 

A few rnontbs agq semod, disk c^ye started 
aaidif it^v^toi infioffi^ 
etecM%as a cause, I used an oiint ttteter to see if 
the Chassis of the drive was grounded. Wdl; low and 

behold, the great thinkeis at Apple hadn't seen fit to 
provide the drives wth an earth ground, I tied a small 
wire to one of the screws on the bottom of each drive, 
and tied these to the chassis of my Apple 11 Plus, 
vtWch doesltave an earth ground Since that time I've 
na^ had «t} uneeii^laiiied disk crash. Does the 
pteeeAisEsmlc^jbatiopui ffl'Justfhe ranti^ of 
anold&rmat? t^nardSlmas 

Hanford, Calif, 

I have an Apple lie, about four years old, which I use 
almost exclusively with j4pple Writer. Usage varies 
quite a bit but typically 111 iiave it up and running one 
or two times a day for 30-60 minutes. What aie tte 
pros and cons of leaving the ^stem on 24 hours per 

^ ' Mam J. Mills 

Can ROB cards or monitors bought in the U.S. be 
used in Europe? 1 find the cassette connections on 
my He quite unutilised. It fhem ansriiiEV pitting 

them to real good use? 

I in my opinion the Snapshot card with Shuttle 
software bom Dark Star lid in^igland is Ihe best 
i^r@telmhappei]!edtoftKjfl^#er^^ 
It allows one to di^ memcny Into ibur wcffkspaces 
and then load in four diferent programs at one time. 
You can switch behyeen them simply pressing a 
button —no rebooting You restart from exactly the 
point you left I regularly use a 551R desktop Apple- 
Wfark^Cqiy [1+, Beagle Qraphics, andadiess program 
in Qelt/Wandln^liehlktwe^ 

Di;S.S.Dalye 
AkuR^Ioe^d 

rfeither Dennis nor I know enough atwuf electronics 
to ansuKr any of these questions, so Dennis caJlcd 
Apple II hardumre guru Jim Sather, author of Brady 
SckA's Ltaderatandii^ the Apjfile U and IMep' 
9t»nil%MejljppIefieanda^dhfffl. ' 

In regard to inverting the monitor picture; Sather 
said the easiest solution is to get a monitor ujith 
inuersion capability built in. Aserand solution uwuld 
be invert the video signal in the Apple before it is 
combined with the sync signal, but this uioutd 
require motherboard modifications that are too 
complex to get Into here. A final solution is to build a 
Uacft bar thaj: str(ps tto ^ncsfgna! (0 of the video 

the amplitude the same), then re^mbinfng the 
■inverted signal with the sync signaL Hfe uittl leaue 
that as an exerdse for the reader. 

fn regard to the (adc of earth grounding on hippie 
<M drtvesi Sather sstd there is m rs^on ffiat the 



drive chassis should hm^e to be grounded, as evi- 
denced by the 2 mfflion pius yipple // owners uitio 
hsBe survived ti\e design without probtems. But the 
graun^nB satoe a pmUem not neoBssai% 
oonnecteif to the /jppte tts^ such as a radto- 
/>e(pie»^ s^naf jton an ou^e 5ouf{K oOTi^iltng 
sigrtais as Oie dtsdc head attempts to (ransiRir (bta. 
Grounding the Apple drives may cure the problem 
by reducing the stret^ of the interference as seen 
by the read/uTfte head. 5athersaid thai if you tiave 
problems with the hard drive, it certainly would 
mafte sense to try the same solution, but suggested 
that j/oudoulile chedc ivith j^harddrwe manuTac- 
tureKs tedmidam to see ^ they haoe a?^ 
tKoH^its on &ie matter. 

. fn regard tciteauingjjourcompateron 24 hoursa 
day: Denns and / had hoth read somewfiere that 
that's what Vioz does, miifit's good enough for hfm 
it suits us, too, if you lesne your computer on at( the 
time it will stay at a constant somewhat warm) 
lieim>erature rather than going through dally ttwm- 
iqi ooolrdam cydes. Leaang it on aootds a poioer 
surge uAen you turn the mac^dne on, leaves your 
fftuAfrie aho^ reac^ to use, and (T j^u are a % 
B^Msk usee, amids the dailj^ del^ while you load 
the RAMdIslc. Sslher disputed most of thai His pmnt 
uas that modem digitaf equipment is very reJiabJe 
and isbuHtlo UJitftsland temperature cyding, Lcauing 
the system on24hous ad^ increases Che probablltly 
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to 100 per cent that if any surges orspite&oocurthey 
wlli happen tyhile the system is on. TTiere is also the 
possibility that constantiy warm components may 
age faster. In summaiy, we judge this to he one of 
those rare and (oonde^ sttuaOons ichere j^u're 
not damned If you do and j^'re not damned {fj^u 
dttnt • 

In regard to the wotid-wlde compatibility of RGB 
interfaces and monitors: Sather said that there is an 
outsitfe chanie thai you couid use the U.S. RGB 
interface and monitor with a Eunapean >lppie He 
motherboard, it depends on.ufheCher Che 60 cyde 
U,S, etpdpmentcms^ to IheSO cyde Meo signal 

staiite. Somewhere we probah^Aaoie H sulscrllier 
who has fried to cross-poilinate the iSdeo in such a 
manner, so / Gtpect to fcnouj more aiout this soon. 

In regard to gadgets that use theJ^ple U cassette 
port; such items are rare, but they do ecist. The 
Cauzin Softstrip reader is an example of a device that 
will hoofc to Che Ue cassette connector, iPennis aiso 
rememjiers a Gsier Ji»m i mtbsia&er pfio was 
itiofMng on a netimriicfhatused Checassefietiaw^ 
ttORs; init Che details escape us, 

fn regard to the Dark Star Snapshot/Shuttle 
comhinafionr I've seen it. It works. 1 like it. Dark Star s 
address is 78 Robin Hood Way, Qreenford, Middlesex 
UB6 7QW fiigiand 0t9Q(h0m, Source Mall flCJ 
43a 

Love's labor's lost? 

mode kx three months, wifh aiU Hae, pm&mu^ 
overtead of the J^ple FrogammMi9 lS(ftteh($. ,jirid 
the toolset intiicades; you begin to seethatwhatever 
the ligs might be, it isn't a proper successor to the 
Apple II. Since I discorered the Apple II in mM-1978, 
nothing has turned my head; I've been faithful 
(except for some C-64 micro "afiairs") ever since. 
Vl^dtins(asweall,llavebefi)iccwliat^IeCom 
Co vnuld do Ilile, (M^^ 
snickeaing ert all the Mac-nuts out there. "Justwait" wc 
said, "tile new II will knock you on your kelsterl" 

Gotta tel! ya. The emperor has no dptlies. Thfe is 
the end of the line for the l[. 

Or is it? 

Seems I've fallen in love iagain. Tills time with 
another "I!," Yeah^ the Plac E Can't affiird one. Can't 
eviBnBBbrdBbookal30iitone.Butcl]eck ttiose specsl 

The ^estiitayf T know for old Apple II note to he^lr 

what I have to say to shut your eyes and pretend that 
the Mac II has a souped up 65816 screaming along at 
10 MHz. When we finish the jpum^i il^s fe#1o open 
our eyes and admit it doesn't 
' open architecture (96-pin nubus) 

* graphics-based opemtir^^stem 

* gre^hicsttiatarecompleteVextendSjlewitlianjr 
appiicatioD8oS»e«e:Chaiiips. 

* gobs aindgdbsMM 

Ten years ago, the Apple II blew the doors off aU the 
other designs of that time. 'Because ft uhs ertendiiite/ 
Because Woz foresau' the natural desip/ieaming/ 
cost reduction curves coming. Do you still Uiink Uie 
11^ Isafitt^succeasw? /don't 

fiiDobeSoering 
Aptos, Calif. 

In its own cfass, the Ilgs blows off my doors for 
pretty much the same reasons the Apple U did. The 
figs is Oie first Af^H^nce Vka'a ot^nal thai was 



designed to take advantage of future developments. 
Future deveiopments such as 1-megabit and 4- 
megabit memory chips. F^iture deveiopments such 
as opticai disics and CD-ROMs. Future deve^ments 
B)3l haven't been designed yeibt^lMve^pbi^^ 
one of those effi^stots. 

£e£fomf houKDec the otdfntegerBaslc dem< 
onstratfon program APPL^SIOPI runs on the Ilgs. 
Almost every trick we've learned over the past 10 
years still works on the Ilgs. The ilgs is a tool that 
real people already laiow how use to make a differ- 
ence in their lives. What makes the lIgs magni/icent 
(and a fitting successor in the Apple II line) is that it 
encompassesboOithe past and the future, l^e don't 
hsoe toffneup the power of the oid white we learn 
how to harness Che neu 

your reai compiaint is ujitfi the /fgs programmer's 
Uforfcshop (the set of system software used to write 
"native mode " or "l&bit" programs for the Ilgs) 
r^her than with the Ilgs itself. The programmer's 
worktop is typicai of the system so/iware we've 
atupis g|otten/ipm4f>i^ 
^:noneibdp^ft%i1nMojP^rte^ 
Apple's assemhleis and oiird-party assemblers. 
ThM of the difference beboeenApplesc^ and Apple- 
soft with GPLE or any of the other good Ime editors. 
Think of the difference between f/L£R and COIWFKT 
and Copy II Plus. 

I think that to be fair we really fiave to 0ve both 
Appie and third-party systems software developers 
more time to show us u)Aat they can do. When the 
mtMoshhxLbeenouifiir as long as Che ffgs has 
kien thtere wa;^1t enen an assemi)Iera(;ai(ahte for it 
—you had to haee a tisa to program the thi;^. The 
Ilgs is far beyond that, but ^i not near where itH be 
in a year or two. The ProDOS 16 it has today is really 
just ProDOS 8 wrapped in a protein coat that ioofcs 
iifce ProDOS 16. The engineers who ujrite languages 
and the engineers who write CooUiac routines are 
stw bjftng (o ^^gure out uih&e tody's tm^ m. 
'n&r^aniiSpec^ilenexaSmsto&sii^. 

I do agree thai super-high-speed super-high- 
resolution graphics don't seem to be a strong point 
of the Ilgs. For people willing to pay for s iiper-high- 
speed and resolution graphics, the Mac II is a 
supeiiormacHlne. But you can buy two Itgssforfhe 
ffdcetif^tnSmiye^^^iedMacliand^haaemm 

cotoriMnUor; and IJVesg qf AW; $5,596 j^r^J*l^ 
U uiiih the same eqi^merit) The Mac n color 
monitor alone costs as much as the Ilgs system unit 
($999). You are comparing two machines that are in 
eritirdy d'^erent price-performance cat^on'es, 

JTie Ugs. itios Its predecesspis, is a posofwt 
emi^t ?nmmcStmifttm:S^ Mtdt tHas the 
iM,^ and M c&mf M^^e^ors, is an 
fitiAtkNwt cofnpiMr. 1^ reDofiiiilonary thing 
aijout ttozniaJt'sj^pptel/ was that it took the power of 
computers out of the hands of instituUons and gaoe 
it to indtuiduals. 7b Oirt Scout tiadge moms and 
Junior Softball coachs and si;cth graders entering 
science fairs. 7b people who can't walk or who can't 
see. R tttierated scientists from institutional pro- 

ditaprooBssfng departments. ITie f/gsispartpf tfiat 
tradUlon.^ f^grams as dbKrse as u1pplelK)rfcs and 
flire Orggin. run on it right nom IVithin eighteen 
months, non-professibnais ujiJi he using new lan- 
guages that take full advantage of the machine's 
powers. Within a few years, rerafutionaiit yet 
undreamed ofsofiime vM mist this fflacMne a 
I^end. 



